home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / copyresp.z / copyresp
Encoding:
Text File  |  2002-10-03  |  6.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ccccooooppppyyyyrrrreeeesssspppp((((DDDD4444))))                                                      ccccooooppppyyyyrrrreeeesssspppp((((DDDD4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _cccc_oooo_pppp_yyyy_rrrr_eeee_ssss_pppp - STREAMS transparent _iiii_oooo_cccc_tttt_llll copy response structure
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_tttt_rrrr_eeee_aaaa_mmmm_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      The _cccc_oooo_pppp_yyyy_rrrr_eeee_ssss_pppp structure contains information in response to a prior copy
  17.      request necessary to continue processing transparent _iiii_oooo_cccc_tttt_lllls.
  18.  
  19. UUUUSSSSAAAAGGGGEEEE
  20.      _MMMM______IIII_OOOO_CCCC_DDDD_AAAA_TTTT_AAAA messages, generated by the stream head, contain the _cccc_oooo_pppp_yyyy_rrrr_eeee_ssss_pppp
  21.      structure.
  22.  
  23.      If an _MMMM______IIII_OOOO_CCCC_DDDD_AAAA_TTTT_AAAA message is reused, any unused fields in the new message
  24.      should be cleared.
  25.  
  26.    SSSSttttrrrruuuuccccttttuuuurrrreeee DDDDeeeeffffiiiinnnniiiittttiiiioooonnnnssss
  27.      The _cccc_oooo_pppp_yyyy_rrrr_eeee_ssss_pppp structure contains the following members:
  28.      _iiii_nnnn_tttt      _cccc_pppp______cccc_mmmm_dddd_;;;;       _////_**** _iiii_oooo_cccc_tttt_llll _cccc_oooo_mmmm_mmmm_aaaa_nnnn_dddd _****_////
  29.      _cccc_rrrr_eeee_dddd______tttt   _****_cccc_pppp______cccc_rrrr_;;;;       _////_**** _uuuu_ssss_eeee_rrrr _cccc_rrrr_eeee_dddd_eeee_nnnn_tttt_iiii_aaaa_llll_ssss _****_////
  30.      _uuuu_iiii_nnnn_tttt______tttt   _cccc_pppp______iiii_dddd_;;;;        _////_**** _iiii_oooo_cccc_tttt_llll _IIII_DDDD _****_////
  31.      _cccc_aaaa_dddd_dddd_rrrr______tttt  _cccc_pppp______rrrr_vvvv_aaaa_llll_;;;;      _////_**** _ssss_tttt_aaaa_tttt_uuuu_ssss _oooo_ffff _rrrr_eeee_qqqq_uuuu_eeee_ssss_tttt _****_////
  32.      _mmmm_bbbb_llll_kkkk______tttt   _****_cccc_pppp______pppp_rrrr_iiii_vvvv_aaaa_tttt_eeee_;;;;  _////_**** _mmmm_oooo_dddd_uuuu_llll_eeee _pppp_rrrr_iiii_vvvv_aaaa_tttt_eeee _dddd_aaaa_tttt_aaaa _****_////
  33.  
  34.      The _cccc_pppp______cccc_mmmm_dddd field is the _iiii_oooo_cccc_tttt_llll command, copied from the _cccc_qqqq______cccc_mmmm_dddd field of
  35.      the _cccc_oooo_pppp_yyyy_rrrr_eeee_qqqq structure.
  36.  
  37.      The _cccc_pppp______cccc_rrrr field contains a pointer to the user credentials.  It is copied
  38.      from the _cccc_qqqq______cccc_rrrr field of the _cccc_oooo_pppp_yyyy_rrrr_eeee_qqqq structure.
  39.  
  40.      The _cccc_pppp______iiii_dddd field is the _iiii_oooo_cccc_tttt_llll ID, copied from the _cccc_qqqq______iiii_dddd field of the
  41.      _cccc_oooo_pppp_yyyy_rrrr_eeee_qqqq structure.  It is used to uniquely identify the _iiii_oooo_cccc_tttt_llll request in
  42.      the stream.
  43.  
  44.      The _cccc_qqqq______rrrr_vvvv_aaaa_llll field contains the return value from the last copy request.
  45.      If the request succeeded, it is set to 0.  Otherwise, if it is non-zero,
  46.      the request failed.  On success, the module or driver should continue
  47.      processing the _iiii_oooo_cccc_tttt_llll.  On failure, the module or driver should abort
  48.      _iiii_oooo_cccc_tttt_llll processing and free the message.  No _MMMM______IIII_OOOO_CCCC_NNNN_AAAA_KKKK message need be
  49.      generated.
  50.  
  51.      The _cccc_pppp______pppp_rrrr_iiii_vvvv_aaaa_tttt_eeee field is copied from the _cccc_qqqq______pppp_rrrr_iiii_vvvv_aaaa_tttt_eeee field of the _cccc_oooo_pppp_yyyy_rrrr_eeee_qqqq
  52.      structure.  It is available so that the module or driver can regain
  53.      enough state information to continue processing the _iiii_oooo_cccc_tttt_llll request.  When
  54.      the _MMMM______IIII_OOOO_CCCC_DDDD_AAAA_TTTT_AAAA message is freed, any message that _cccc_pppp______pppp_rrrr_iiii_vvvv_aaaa_tttt_eeee refers to is
  55.      not freed by the STREAMS subsystem.  It is the responsibility of the
  56.      module or driver to free it.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccooooppppyyyyrrrreeeesssspppp((((DDDD4444))))                                                      ccccooooppppyyyyrrrreeeesssspppp((((DDDD4444))))
  71.  
  72.  
  73.  
  74. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  75.      _cccc_oooo_pppp_yyyy_rrrr_eeee_qqqq(D4), _dddd_aaaa_tttt_aaaa_bbbb(D4), _iiii_oooo_cccc_bbbb_llll_kkkk(D4), _mmmm_eeee_ssss_ssss_aaaa_gggg_eeee_ssss(D5), _mmmm_ssss_gggg_bbbb(D4)
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.